<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<!--
----	(c) Copyright 2002-2011 by Nehal Mistry, Francois Beerten and Pali Rohár

----    This program is free software; you can redistribute it and/or modify
----    it under the terms of the GNU General Public License as published by
----    the Free Software Foundation; only version 2 of the License.
----
----    This program is distributed in the hope that it will be useful,
----    but WITHOUT ANY WARRANTY; without even the implied warranty of
----    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
----    GNU General Public License for more details.
----
----    You should have received a copy of the GNU General Public License
----    along with this program; if not, write to the Free Software
----    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
----    02110-1301, USA.
-->
    <title>Stratagus Installation</title>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>

<body>

<pre width=80>
         _________ __                 __
        /   _____//  |_____________ _/  |______     ____  __ __  ______
        \_____  \\   __\_  __ \__  \\   __\__  \   / ___\|  |  \/  ___/
        /        \|  |  |  | \// __ \|  |  / __ \_/ /_/  >  |  /\___ \
       /_______  /|__|  |__|  (____  /__| (____  /\___  /|____//____  >
               \/                  \/          \//_____/            \/
    ______________________                           ______________________
                          T H E   W A R   B E G I N S
           Stratagus - A free fantasy real time strategy game engine
</pre>
<hr>

<h1>Installation instructions for Stratagus</h1><p>
<hr>

    <h2>Software Requirements</h2>
    <ul>
	<li><b>A supported operating system:</b> Linux, Mac OS X, BSD,
	Possibly any other Unix/POSIX OS.<br>
	Microsoft Windows 98 SE, or higher.
	<font color=red>NOTE: some features of Winsock2 (WS2_32.DLL) are used. So even
	if you plan to play single player only,
	WinNT4.0 users will need
	<a href="http://www.microsoft.com/ntserver/nts/downloads/recommended/SP6/allSP6.asp">Service Pack 3 or higher</a>
	and Windows 95 users will need the
	<a href="http://www.microsoft.com/windows95/downloads/contents/WUAdminTools/S_WUNetworkingTools/W95Sockets2/Default.asp">winsock 2 update</a>.</font><p>

	<li><a href="http://www.cmake.org/">CMake</a> (required).<p>
	<li><a href="http://www.libsdl.org/">SDL</a> (required).<p>
	<li><a href="http://www.libpng.org/pub/png/">libpng</a> (required).<p>
	<li><a href="http://www.gzip.org/zlib/">zlib</a> (required).<p>
	<li><a href="http://www.lua.org/">Lua 5.1</a> (required).<p>
	<li><a href="http://www.codenix.com/~tolua/">Tolua++</a> (required).<p>
	<li><a href="http://www.xipg.org/">libogg</a> (recommended).<p>
	<li><a href="http://www.xiph.org/ogg/vorbis/">libvorbis</a> (recommended).<p>
	<li><a href="http://www.theora.org/">libtheora</a> (recommended).<p>
	<li><a href="http://www.fluidsynth.org/">libfluidsynth</a> (recommended).<p>
	<li><a href="http://mikmod.raphnet.net/">libmikmod</a> (optional).<p>
	<li><a href="http://sources.redhat.com/bzip2/">libbzip2</a> (optional).<p>
	<li><a href="http://www.libmng.com/">libmng</a> (optional).<p>
	<li><a href="http://www.sqlite.org/">SQLite</a> (optional).<p>
	<li><a href="http://www.doxygen.org/">DoxyGen</a> (optional).<p>

	<a href="https://launchpad.net/stratagus">A stratagus game</a>.<br>
    </ul>

    <h2>Hardware Requirements</h2>
    <ul>
	<li><b>Processor:</b> A 300 MHz CPU (faster recommended).<br>
	<font color="red">NOTE: Stratagus is believed to be endian and word size safe, so other
	architectures like (big endian) PPC or (64bit) Alpha should also
	work at least with Linux.</font><p>

	<li><b>Memory:</b> 32 MB of RAM (64 MB for ogg support).<br><p>

	<li><b>Video Card:</b> Any graphics card that can handle 16 bpp
	and 640x480 is supported. (OpenGL is supported, and requires a 32MB Card)<p>

	<li><b>Sound Card:</b> Recommended. SDL compatible sound cards are supported.<p>
    </ul>

    <h2>Installation</h2>

    <ul>
	<li><b>Step 1, Download and Extract:</b><p>

	<ul>
	    <li><a href="https://launchpad.net/stratagus">Download</a> the source code.<br>

	    <li>Extract the source stratagus-VERSION.tar.gz with
	    'tar -zxvf stratagus-VERSION.tar.gz'
	</ul>

	<br>
	<li><b>Step 2, Compile:</b><p>

	Create 'build' directory in toplevel stratagus tree and here run:<br />
	'cmake .. &amp;&amp; make'<p>

	<br>
	<li><b>Step 3: Build packages</b><p>

	This step is optional.<br />
	You can build debian packages by using 'debuild' directly.<p>

	<br>
	<li><b>Step 4, Run:</b><p>

	You may now go into the toplevel stratagus directory and run the binary.
	Remember, you have to obtain the
	<a href="https://launchpad.net/stratagus">game data</a>
	to start the engine. By default, stratagus looks in './data',
	if your data is in a different location you
	will need to run stratagus with '-d /path_to_data'.<p>
    </ul>

<hr>
(C) Copyright 1998-2015 by The <a href="https://launchpad.net/stratagus">Stratagus</a> Project under the <a href="gpl.html">GNU General Public License</a>.<br>
All trademarks and copyrights on this page are owned by their respective owners.<br>
</body>
</html>
